package com.tianji.learning.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.common.domain.query.PageQuery;
import com.tianji.learning.domain.dto.LearningPlanDTO;
import com.tianji.learning.domain.po.LearningLesson;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.learning.domain.vo.LearningLessonVO;
import com.tianji.learning.domain.vo.LearningPlanPageVO;

import java.util.List;

/**
 * <p>
 * 学生课程表 服务类
 * </p>
 *
 * @author mxl
 * @since 2024-06-25
 */
public interface ILearningLessonService extends IService<LearningLesson> {

    /**
     * 为用户添加课程
     * @param userId 用户id
     * @param courseIds 需要添加的课程信息
     */
    void addUserLesson(Long userId, List<Long> courseIds);

    /**
     * 分页查询我的课程
     * @param query 查询参数
     * @return 分页信息
     */
   PageDTO<LearningLessonVO> queryMyLession(PageQuery query);

    /**
     * 查询正在学习的课程
     * @param query 查询参数
     * @return 分页信息
     */
    LearningLessonVO queryMyCurrentLession(PageQuery query);

    /**
     * 删除对应课程
     * @param courceId 要删除的课程id
     */
    void deleteLession(Long courceId);

    /**
     * 验证课表中的课程是否过期
     * @param courseId 课程id
     * @return 过期返回null 不过期返回课表id
     */
    Long isLessonValid(Long courseId);

    /**
     * 根据id查询指定课程的学习状态
     * @param courseId 课程id
     * @return 课程学习状态
     */
    LearningLessonVO queryState(Long courseId);

    /**
     * 查询该课程的学习人数
     * @param courseId 课程id
     * @return
     */
    Integer countLearningLessonByCourse(Long courseId);

    /**
     * 创建学习计划
     * @param dto 学习计划参数
     */
    void createLearningPlan(LearningPlanDTO dto);

    /**
     * 分页查询我的学习计划
     * @param pageQuery 分页参数
     * @return 分页信息
     */
    LearningPlanPageVO queryMyPlans(PageQuery pageQuery);

    /**
     * 删除课表
     * @param userId 用户名
     * @param courseIds 课程id列表
     */
    void deleteLession(Long userId, List<Long> courseIds);
}
